package net.zoneland.zrdp.framework.web.service;

import java.io.IOException;
import java.util.List;

import org.springframework.web.multipart.MultipartFile;

import net.zoneland.oadocs.sdk.pojo.DocCreateRequest;
import net.zoneland.oadocs.sdk.pojo.DocDetailInfo;

/**
 * 后台附件操作服务接口类.
 * @since 2020/9/16
 **/
public interface WpsAttachmentService {

    /**
    * 获取最新的appKey.
    * @author pbody
    * @param oldAppKey 老的appKey
    * @return java.lang.String
    */
    String getNewAppKey(final String oldAppKey);

    /**
     * 获取当前的appKey.
     * @return java.lang.String
     */
    String getCurrentAppKey();

    /**
     * 根据目录id获取该id其下所有的文件. 包含子目录的文件
     * @param folderId 目录ID
     * @return  结果list
     */
    List<DocDetailInfo> getAttachmentsByPid(final String folderId);

    /**
     * 上传附件.
     *
     * @param file 附件
     * @param fileId 原文件ID
     * @param folderId 文件夹ID
     * @return java.lang.String wps上的文件id
     * @throws IOException 异常
     */
    String upload(final MultipartFile file,  final String fileId, final String folderId) throws IOException;

    /**
     * 创建文件或者文件夹
     * @param createRequest 需要创建的信息
     * @return 文件或文件夹的id
     */
    String createFileOrFolder(final DocCreateRequest createRequest);

    /**
     * 据附件fileId获取预览链接.
     * @author helu
     * @Date 16:21 2024/3/11
     * @param fileId 附件ID
     * @return java.lang.String
     */
    String getPreviewLink(final String fileId);

    /**
     * 据附件fileId获取下载链接.
     * @author helu
     * @Date 16:21 2024/3/11
     * @param fileId 附件ID
     * @return java.lang.String
     */
    String getDownloadLink(final String fileId);

    /**
     * 批量删除附件.
     * @author helu
     * @Date 16:33 2024/3/11
     * @param fileId 附件ID，多值用,隔开
     * @return java.lang.String
     */
    int deleteFiles(final String fileId);

    /**
     * 获取文件夹下的第一个文件.
     * @author helu
     * @Date 10:55 2024/3/20
     * @param folderId 文件夹ID
     * @return net.zoneland.oadocs.sdk.pojo.DocDetailInfo
     */
    DocDetailInfo getOneFileByFolderId(final String folderId);

    /**
     * 获取文件夹下第一个文件的下载地址.
     * @author helu
     * @Date 11:16 2024/3/20
     * @param folderId 文件夹ID
     * @return 下载地址
     */
    String getDownUrlByFolder(final String folderId);
}
